TECHNICAL SUPPORT SERVICE FOR COMMODORE / AMIGA 
Assistance for Application Developers 


SUBSCRIBER’S MANUAL 


The Commodore / Amiga Support Service 


The Support Service is designed to streamline application development by providing 
quick access to technical information and documentation. A technically trained on-line 
support staff is present for resolution of problems encountered during the development of 
Amiga software. 


Subscribers have access to the support service and data bases 24 hours a day via an 
on-line telecommunications system. Support service users can expect prompt answers to 
technical questions via electronic mail. Additional information regarding documentation, 
programming tips and operational knowledge of Amiga and Amiga Development System 
hardware will be indexed in the documentation data base. 


Equipment and Settings 

In order to communicate with the on-line Support System two items are needed: 
1. Any common terminal or microcomputer with a terminal emulator. 
2. A 1200 or 300 baud Bell-compatible modem. 


Subscribers will be asked prior to their first login to specify the type of of terminal/emulator 
which will be used. 


Communication settings for the dial-up service are: 
& data bits, 
no parity, 
one Stop bit. 


The support service has been designed for a termina} with: 
80 columns, 
24 lines, 
lowercase, 
cursor control. 


In particular for subscribers with SUN systems: 


A) because the SUN won’t let the “Q character pass out the port other- 
wise, a call must be made to stty in the form: 
stty Start “w 
This will change the character to start scrolling to “W instead of “Q. 


B) the settings for TIP(1C) should be: 
1. [pa]rity always zero, 
2. [r]aise [c]har must be changed to something other than “A, 
if on-line help is to be accessed. 
Note that these are TIP(1C) variables, which may be set 
in a .tipre file or by using the tip set command (a -s prefix). 
Alternatively, these variables can be set in your /etc/remote file, 
which would look something like this: 


support:\ 
:dv=/dev/cau0:el=*D*° U*C*S*Q*O@:ie=4$%:0e=" D:br#1200:be=false:\ 
pa=zero:rc="B: 


Note particularly the last line, where parity is shut off, 
and the raise char is set to control-B. 


See TIP(1C) and REMOTE(S) for more details. 


Users of Racal-Vadic modems may at times have some difficulty making the connection 
to the on-line service. The problem apparently resides with the proprietary communication 
protocol that is used in these modems. However, successive retries will assure success. 


Accessing the Technical Support Service 


Electronic access to the TECHNICAL SUPPORT SERVICE is obtained by calling 
support at: 
(408) 986-8311 


Subscribers will have been given their account login name and password. When connection 
has been made with the Technical Support Service computer, the user will be prompted: 


edjr login: 


At which point they should type in their login name, followed by a carriage return. The user 
is then prompted for a password. If the user makes an input error, the login prompt 
sequence is repeated. If the user is unable to obtain entry after several attempts then a call 
can then be made to the Technical Support Service at (408) 727-2255 for a resolution of 
the problem or verification of the user’s subscription status. 


In the event that a subscriber’s password has become known to others or that password 
security is in question, a new password may be obtained by sending a message to the 
Support Staff via the Message Center stating a new password and the day it is to take effect. 
The password must be between five and eight characters long inclusive. 


Hours of Availability 


The Technical Support Service is accessible 24 hours a day. Responses to subscriber 
inquiries can be expected on a same day basis during normal! business hours (Pacific Coast 
Time). At times there will be a need for down time and system maintenance, usually in 
midmorning hours. The subscriber can expect prior notification of pending down time to 
adjust accordingly. 
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Introduction to Amiga Errata 


To see the available typefaces and type sizes, type in a note, then try 
each of the choices. The currently chosen typeface is shown with a check 
mark to the left of the menu item. In addition, the currently chosen 
type size is shown with a check mark if there is more than one size for 
the currently chosen typeface. 


Note that the currently chosen typeface and type size apply to the entire 
note. 


When you choose a new typeface and type size, a previous type size you 
chose for a different typeface may still have a check mark to the left of 
it. If this is the case and you attempt to choose the previous typeface 
again, nothing may happen. If this should occur, choose another type 
size for the previous face, then choose the size you want. 


Style Menu 


From this menu, you can choose either standard (Plain) characters for 
your note, or change the type style by choosing Italic, Bold, Underlined, 
or any combination of the three. At any point in your note you can 
choose a new type style; this sets a marker in your note and all the 
characters from this marker to the next (or to the end of the file, if there 
are no other markers) are changed to the new style. Try the different 
choices and watch how your note changes. 


Note that when you choose Italic, Bold, or Underline, your choice stays 
in effect until you choose Plain. 


There are command-key shortcuts for each of the items in this menu: 


press the right Amiga key and the P key at the same time to choose 


Plain; the right Amiga key and the I key to choose Italic; the right Amiga 
key and the B key to choose Bold; the right Amiga key and the U key to 
choose Underline. As a reminder, the shortcut for each item is shown 
in the menu to the right of the item. 
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Format Menu 


Paper Color lets you choose the background color for your note. 
Choose a color from the four shown in the submenu (see the description 
of the Font menu above to learn how to choose from a submenu). The 
currently chosen color is indicated by a check mark. 


Pen Color lets you choose the color of the characters in your note. 
Choose a color from the four shown in the submenu (see the description 
of the Font menu above to learn how to choose from a submenu). The 
currently chosen color is indicated by a check mark. 


Be sure that the pen color is different from the paper color; if you don’t, 
you won't be able to read your note. 


There are two additional gadgets in the Notepad window. The gadget at the lower 
left is the Next Page gadget. Select this gadget to display the next page of your note. 
The gadget in the upper right is the Previous Page gadget. Select this gadget to 
display the previous page of your note. 


Page 7-5: The baud rate 110 does not work. 


Page 7-5: Preferences also lets you modify the Pointer. When you select the Edit 
Pointer gadget, a window appears. In this window, a magnified image of the Pointer 
appears at the upper left. It is this magnified image that you modify to change the 
Pointer. To the right of the magnified view are copies of the Pointer that appear 
against each of the four Workbench colors; these copies let you judge how the 
Pointer will look against the colors on the Workbench. 


The colors you use to draw the Pointer appear near the bottom of the requester. 
Note that these colors can be different from those used for the Workbench. You can 
modify the three colors to the left in the same way you modify the Workbench 
colors: by changing the R, G, and B values for each. The rightmost “color” is not a 
color at all: any parts of the Pointer you draw with it are transparent. When you 
move the Pointer, colors on the Workbench behind any transparent parts of the 
Pointer show through. If, after you modify the Pointer colors, you want get back the 
last colors that were saved, select the ResetColor gadget. 
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To modify the Pointer, select one of the colors or transparent, point to a place in the 
magnified view where you want a pixel of that color, then click the Selection button. 
If you want to start from scratch, select Clear to make all the pixels transparent. (If, 
after you make changes, you’d rather have the old Pointer back, select Restore.) 


Every Pointer has a “point,” the single pixel that you must position over something 
onscreen to point it. The point is indicated in the magnified view by a smaller 
square within one of the pixels. To change the Pointer’s point, select Set Point, 
point to the pixel in the magnified view you want as the point, then click the 
Selection button. 


When you’re done and are happy with the Pointer you’ve created, select OK. To get 
back to the main Preferences screen without changing the previous Pointer, select 
Cancel. 


Page 7-9: When you select either OK or Cancel in the Printer Graphics Requester, 
you return to the Printer Requester. 


ADDITIONAL NOTES 


A requester may appear that asks you to put a particular disk in “any drive.” If, 
when put in the disk, the requester reappears, remove it and put it in the other drive. 


Drawers can exist within drawers. Do not attempt to move the icon for an “outer” 
drawer into a drawer that is contained within it. 


The disk containing free software from Electronic Arts includes both a “slide show” 
and a demonstration of the “Polyscope.” To use the Electronic Arts disk, do one of 
the following: 


IF YOU HAVEN’T ALREADY TURNED ON THE AMIGA, turn it on, 
then insert the Kickstart disk (see pages 3-4 to 3-6 in Introduction to Amiga 
to learn how). When the picture of a hand holding a Workbench disk 
appears, insert the Electronic Arts disk. 


IF YOU’VE ALREADY USED THE KICKSTART DISK and the Amiga is 
on, insert the Electronic Arts disk, then reset the Amiga by pressing at the 
same time the CTRL key, the left Amiga key (the key immediately to the left 
of the Space Bar at the bottom of the keyboard), and the right Amiga key 
(the key immediately to the right of the Space Bar). 
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After you do, a message appears. Type either “SlideShow” or “PolyScope” then 
press the RETURN key on the keyboard. You'll then get instructions for what to do 
next. (In these instructions, note that “type ESC” means to press the ESC key on 
the keyboard and “type <RETURN>” means to press the RETURN key.) 
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System Problems 
Users receiving any system error messages are requested to send a message to the 
Support Staff via the Message Center indicating that: 


1. a system error has occurred; 
2. the location of the user when the error occurred; 
3. the time of occurrence of the error. 


Correction of the problem will be given top priority. However, in the event the Message 
Center may not be usable, users should call the Technical Support Service at (408) 
727-2255. 


A Walk Through the Support System 


The Technical Support Service has been designed to be extremely easy to use. Upon 
success entry into the Technical Support Service, the user will be presented with the 
welcoming banner. As instructed, pressing any key will present the user with the Main 
Menu: 


Technical Support for the Commodore AMIGA 
* Main Menu * 


1) Message Center 

2) Research Center 

3) News Center 

4) Info Center 

5) Documentation Center 
6) Download Center 

0) Exit 

Selection: 


At this point, a selection of 1,2,3,4,5 or 6 followed by a carriage return will result in entry 
into the specified Support Center. A number of significant control characters are utilized as 
commands throughout the system providing uniformity in the user interface. 


These characters and their action are as follows: 


Group Keys Function Description 

Data entry [Return] End-—of-text End fixed-length text entry; 
new line for multi-line text 
entry. 


[°Z] End-of-text End multi-line text entry. 


Exit/Abort [*Q] Exit Normal exit to next higher menu 
or function level. 


{*C] Abort Abort current task without 
saving data local to this task, 
returning to next higher 
menu or function level. 


View Text [*D] Page down Page forward through free 
form text. | 
[*U] Page up Page backward though free 
form text. 
[‘N] Next View next item 
[°P] Previous View previous item 
[*T] Text only Page forward through free— 


form text, using entire screen 
for display of data. May be 
use for transfer of text. 


Other [*A] Help Ask system for additional 
information. 
[“L] Redraw Redraw screen 
[*R] Remove Remove (delete) currently 


selected item. 
Inside the Technical Support Service 


The Technical Support Service for Amiga includes electronic access to a variety of 
support centers, all indicated in the main menu: 


Message Center 


The Message Center allows subscribers to send messages to or review messages from the 
Technical Support Staff. The user can make requests for individual assistance in cases 
where they cannot locate the required information within the other support centers. 


To send a message, the user is first prompted for a title or subject up to 70 characters; 
the cursor then moves to the body of the message. The message may be up to 200 lines of 
79 characters each. Each line can be edited using backspacing as it is entered. Editing can 
take place ONLY on the current line with the cursor. Entry of a [“Z] at any point in text 
entry will terminate and send the message to the Technical Support Staff. Entry of [*C] will 
immediately abort the whole process with no message sent. 


To find responses to your inquiries, the "Review Messages” option may be selected. If 
there are no responses pending from the Technical Support staff, the user will be notified 
and returned to the Message Center menu. Messages that have arrived will be viewed in 
reverse time-—date order with the most recent response listed first. Messages may be flipped 


through by using [“N] (next) or [*P] (previous) control keys. The text of each message can 
be paged up or down with [“U] or [“D]. A Full screen display of text may be selected with 
a [“T] option which may be use to transfer the message to a local computer or printer. 
Select [*R] to remove the message that is present on the screen. The selection of [*Q] will 
provide an exit from "Review Messages” to the Message Center. 


Research Center 


This database allows on-line retrieval of summarized questions and resolutions from 
previous requests for assistance. Organized in a-structured manner, the Research Center 
allows efficient access to information relevant to a subscriber’s current problem. Upon 
entering the Research Center, the user is presented with a screen to access the data by 
subject. Data access is usually accomplished by: 


1. Input of a keyword or string; 
2. Selection of the appropriate index number. 


A user should first type in a suitable keyword or string up to 34 characters. The first 
character of the input string must be non-numeric, as numeric values select the associated 
index number, yielding the text to be viewed. If an exact match is found with the keyboard 
input, that index will be the first one displayed in the viewing window. If an exact match is 
not found, then the closest previous index will be the first one displayed. Possible related 
entries may follow. From this point on the user may select the appropriate index number to 
view the text of the associated index. Any valid index number will be accepted. Selection of 
the appropriate index number will display the associated text. Each subject presents both 
the problem and solution. Within any item, the user may page up [“U], down [*D] or view 
full-screen text [“T]. 


News Center 


The News Center enables on-line retrieval of current news items and announcements 
regarding Commodore. The operation of the News Center is similar to the Message Center 
except that news items cannot be removed by subscribers. Items can be scanned 


one-by—one with the latest announcements presented first. Within any item the user may 
page up, down, or view full-screen text. 


Info Center 


Supplementing the Research Center is the Info Center, which provides on-line retrieval 
of detailed technical information relevant to Amiga development. Operation of the Info 
Center is similar to the Research Center: the user is presented with an index to access the 
data by subject. Within any item the user may page up, down, or view full-screen text. 


Documentation Center 


The Documentation Center provides on-line retrieval of documents relevant to Amiga 
software development. Typical documents include the hardware and software manuals, the 
Technical Support System’s Users Manual and a variety of documentation not generally 
distributed, as it becomes available. Upon entering the Documentation Center the user is 
presented with a menu of available documents and prompted for a selection. Operation 
from this point on is the same as to the Research Center. Each document is indexed 


internally for access by subject or section. The user can then page up, down, or view 


l-screen text. 


For example, suppose a subscriber needs to find the information about Bob color 
selection. He would first get into the documentation center, by typing "5" at the main 


menu. Here they would be presented with this screen: 


Technical Support for the Commodore AMIGA 


* Documentation Center 


1 Support System Manual 


2 Amiga Hardware and Software Manuals (V24) 


3 Amiga Hardware Manual (separated) 


4 Text Support 
§ Intuition 


6 Intuition Programmers’ Guide 


7 intuition. h 


8 Latest Sound Guide 
9 Changes in ROM v23 


10 23do0c2 


11 Document Current Revision Dates 

12 2/21/85 update information 

13 V23 Include-file listings 

14 V23 Library Interface — Assembly Listings 
15 V23 unix~like exec summaries 


Typing a "2” without the quotes would reveal this screen: 


Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 
Copyright 


Technical Support for the Commodore AMIGA 


Document: Amiga Hardware and Software Manuals (V24) 


No. Subject 


* Select Document Subject 


* 


Copyright 


1984, 1985 
1984, 1985 
1985 
1985 
1985 
1985* 
1985 
1985 
1985 
1985 


1984, 1985 


ArwAINN khWNY 


/BLS pin, disable discription 

128k; appendix D; system memory submap 
256k; appendix D; system memory submap 
300 baud; setting the modem to 

512k; appendix D; system memory submap 
6522 chip address summary; appendix D 
6522 pin assignments; even 

6522; carrier detect on 


9 6526 chip address summary; appendix D 
10 6526 control registers 
11 6526 group connector pins; appendix E 


12 6526 peripheral interface adaptors | Appendix F start 


i ee 


Selection: 
Subject | [“D] Down | [“U] Up | No. (Select) | ["A] Help | [*Q] Exit 


This is the first page of indeces into the document. So now, by typing “color” without the 
quotes (color is the Subject), the user would call up this screen of indexes: 


Technical Support for the Commodore AMIGA 
* Select Document Subject * 


Document: Amiga Hardware and Software Manuals (V24) Copyright 1984, 1985 


No. Subject 


421 collisions; handling multiple 

422 color bit interpretation, bits which control 
423 color charts; playfield selection 

424 color clock and DMA timing 

425 color clock description (hardw. chap. 7.9) 
426 color clock quadrature signal description 
427 color example one: color selection using one bit-plane; playfield 
428 color information for the video lines 

429 color register bit interpretation 

430 color selection (multiple planes); bit-plane 
431 color selection; dual playfield mode 

432 color selection; hplayfield element 


Selection: 
Subject | [“D] Down | [“U] Up | No. (Select) | [*A] Help | [*Q] Exit 


Since the subscriber would not see the reference to Bob color desired, 
He would then type a ”“D” to see the next segment of the index: 


Technical Support for the Commodore AMIGA 
* Select Document Subject * 


Document: Amiga Hardware and Software Manuals (V24) Copyright 1984, 1985 


No. Subject 


432 color selection; hplayfield element 

433 color selection; single playfield mode 

434 color tables | COLORxx description 

435 COLOR, BPLCON bit description, appendix A 
436 COLOR31 address, appendix B 

437 colors are controlled; how bob 

438 colors for attached sprites; selecting the 

439 colors interact; how vsprite and playfield 


440 colors of a bob; specifying the 

441 colors of a vsprite; specifying the 
442 colors; other items influencing bob 
443 colors; selecting sprite 


Selection: 
Subject | [“~D] Down | [“U] Up | No. (Select) | [°"A] Help | [*Q] Exit 


Now the user can choose among several indexes about bobs and color. 
Alternatively, typing "bob” without the quotes would generate this 
screen of indexes: 


Technical Support for the Commodore AMIGA 
* Select Document Subject ° 


Document: Amiga Hardware and Software Manuals (V24) Copyright 1984, 1985 


No. Subject 


309 BLTxPTL register description, appendix A 
310 bob advanced topics 

311 bob colors are controlled; how 

312 bob colors; other items influencing 
313 bob drawing order; specifying the 
314 bob flag, use of bob flags; sav 

315 bob flags; bdrawn flag, use of 

316 bob flags; bwaiting flag, use of 

317 bob flags; gelgone flag, use of 

318 bob flags; overlay flag, use of 

319 bob flags; saveback flag, use of 

320 bob flags; savepreserve flag, use of 


Selection: 
Subject | [“D] Down | [“U] Up | No. (Select) | [“A] Help | [°Q] Exit 


Note that many areas of the manual have duplicate indexes; in this example indexes number 
437 and 311 point to the same manual page, as do 442 and 312. This is intended to ease 
tracking down seemingly elusive information. So, if what you are looking for isn’t indexed 
under one keyword, try a different one that is in some way connected to the main subject of 
interest. 


Download Center 


On a unix machine, the best way to download will be to type the command line: 

tip mymodem | tee newfile’ 
which will put all output from the tip session into the file "newfile”. After selecting the 
download center from the main menu, select which document you’d like. If you don’t want 
to download after all, type a ’0’ (zero). If you’re on a sun, choose (1), so you’ll recieve the 
file with linefeeds only (CR not wanted). Ignore what the file looks like as it scrolls by. If 


you’re on a pc, you'll probably want the CR,L combination, so choose (2). 


NOTE! Once you select (1) or (2), you have to be patient, 
NOTE! Because there’s no way to stop it. 


Unix users will, after exiting the tip as usual, edit the file "newfile” to take out all the 
spurious lines. 


LIMITATIONS OF LIABILITY 


Commodore disclaims all warranties with regard to the volume, completeness, technical 
accuracy and technical adequacy of the information provided by the Technical Support 
Service. Commodore shall not be liable to subscriber, subscriber’s customers or users of 
products for any direct, indirect, special, incidental, consequential or other damages arising 
from the use of the Technical Support Service. Commodore will provide the services 
described herein with its best efforts and makes no representations concerning the fitness or 
merchantability of information obtained from the Technical Support Service. 


Technical Support Service Phone 
(408) 727-2255 

Electronic Access Support System Phone 
(408) 986-8311 


To receive your login please fill out and return the following form to: 


Perennial Software Services Group 
3130 De La Cruz Blvd. 
Santa Cruz, CA $5054 


Company Name: 
Company Phone: 
Primary Contact : 
Secondary Contact: 
Terminal Type: 


After we receive this information, we will communicate your new login and password to the 
above named contact person. 


this document was 
generously 
contributed by 


randell jesup 


scanned by: 
www.commodore.international 


